Create Trade Request

POST /api/trade-requests

Description

Create a new trade request.

Path Parameters

Name	Type	Description
None		No parameters

Request Headers

Name	Type	Description
tenantId	string	The tenant ID (header)
userId	string	The user ID (header)
countryCode	string	The country code (header)

Request Body

• Content Type: application/json

{
  "productId": "string",
  "requestId": "string",
  "quantity": 0,
  "testingRequired": true,
  "productSpecification": "string",
  "termsAndConditions": "string",
  "docLinks": [
    {
      "name": "string",
      "link": "string"
    }
  ],
  "businessId": "string",
  "userId": "string",
  "sellers": [
    {
      "firstName": "string",
      "lastName": "string",
      "username": "string",
      "phone": "string",
      "quantity": 0,
      "country": {
        "name": "string",
        "code": "string",
        "currency": "string"
      },
      "productUnitType": "Barrels",
      "docLinks": [
        {
          "name": "string",
          "link": "string"
        }
      ]
    }
  ],
  "tenantId": "string",
  "countryCode": "string"
}

Response Code: 201 - Created

Description

Trade request created successfully.

Headers

Content-Type	Value
apiKey	{{apiKey}}
tenantId	string
userId	string
countryCode	string

Body

{
  "productId": "prd123",
  "requestId": "req456",
  "quantity": 100,
  "testingRequired": true,
  "productSpecification": "High quality",
  "termsAndConditions": "Standard terms",
  "docLinks": [
    {
      "name": "Specification Document",
      "link": "http://example.com/specification"
    }
  ],
  "businessId": "bus789",
  "userId": "usr456",
  "sellers": [
    {
      "firstName": "Jane",
      "lastName": "Doe",
      "username": "janedoe",
      "phone": "1234567890",
      "quantity": 100,
      "country": {
        "name": "CountryName",
        "code": "CNC",
        "currency": "USD"
      },
      "productUnitType": "Barrels",
      "docLinks": [
        {
          "name": "Contract Document",
          "link": "http://example.com/contract"
        }
      ]
    }
  ],
  "tenantId": "tenant123",
  "countryCode": "CNC"
}

🔑 Authentication bearer

Param	Value	Type
token	{{accessCode}}	string